Programmers Aid for 


ATARI® Computers * 3.98 “ST 

Reg. A Warner Communications Company M'WD INC. 


BASIC KEYWORDS 



ERROR MESSAGES 

* 


ATARI HUES 


Word 

Token 

Word 

Token 

Code 

ABS. 

.79 

Next. 

.9 

2 

ADR. 

.67 

NOT. 

.40 

3 

AND. 

.42 

NOte. 

.27 

4 

ASC. 

.64 

ON. 

.30 

5 

ATN. 

.68 

Open. 

.23 

6 

Bye. 

.14 

OR. 

.41 

7 

CLOAd. 

.53 

PADDLE .... 

.81 

8 

CHR$. 

.62 

PEEK. 

.70 

9 

CLOG. 

.76 

PLot. 

.44 

10 

CLose. 

.17 

Point. 

.28 

11 

CLR. 

.18 

POKe. 

.31 

12 

Color. 

.3 

POP. 

.39 

13 

COM. 

.16 

POSition .... 

.45 

14 

CONt. 

.15 

PRint. 

.32 

15 

COS. 

.69 

PTRIG. 

.83 

16 

CSAVE. 

.52 

PUt. 

.42 

17 

Data. 

.1 

RAD. 

.33 

18 

DEg. 

.19 

REAd. 

.34 

Input, 

Dim. 

.20 

Rem. 

.0 

19 

DOs. 

.46 

RE Store. 

.35 

20 

DRawto. 

.47 

RETurn. 

.36 

21 

END. 

.21 

RND. 

.72 

128 

Enter. 

.5 

RUn. 

.37 

129 

EXP. 

.74 

Save. 

.25 

130 

For. 

.8 

SEtcolor. 

.48 

131 

FRE. 

.73 

SGN. 

.78 

132 

GEt. 

.41 

SIN. 

.71 

133 

GOSub. 

.12 

SOund. 

.50 

134 

Goto. 

.10 

SQR. 

.77 

135 

GRaphics. 

.43 

STatus. 

.26 

136 

IF. 

.7 

STEP. 

.26 

137 

Input. 

.2 

STICK. 

.82 

138 

INT. 

.80 

STRIG. 

.84 

139 

LEN. 

.66 

STOp. 

.38 

140 

LEt. 

.6 

STR$. 

.61 

141 

List. 

.4 

THEN. 

.27 

142 

LOad. 

.24 

TO. 

.25 

143 

LOCate. 

.49 

Trap. 

.13 

144 

LOG. 

.75 

USR. 

.63 

145 

LPrint. 

.51 

VAL. 

.65 

146 

NEW. 

.22 

Xio. 

.29 

147 


musical! pitch 

NOTES ■ VALUES 


high 

notes 


middle 


low 

notes 


C 

B 

A# or Bb 
A 

G# or Ab 
G 

F# or Gb 
F 
E 

D# or Eb 
D 

C# or Db 
C 
B 

A# or Bb 
A 

G# or Ab 
G 

F# or Gb 
F 
E 

D# or Eb 
D 

C# or Db 
C 
B 

A# or Bb 
A 

G# or Ab 
G 

F# or Gb 
F 
E 

D# or Eb 
D 

C# or Db 
C 


29 

31 

33 

35 

37 

40 

42 

45 

47 

50 

53 

57 

60 

64 

68 

72 

76 

81 

85 

91 

96 

102 

108 

114 

121 

128 

136 

144 

153 

162 

173 

182 

193 

204 

217 

230 

243 


160 

161 

162 

163 

164 

165 

166 

167 

168 

169 

170 

171 


Message 

Memory Insufficient 

Value Error 

Too Many Variables 

String Length Error 

Out of Data Error 

Number greater than 32767 

Input Statement Error 

Array or String DIM Error 

Argument Stack Overflow 

Floating Point Overflow/Underflow Error 

Line Not Found 

No Matching FOR Statement 

Line Too Long Error 

GOSUB or FOR Line Deleted 

RETURN Error 

Garbage Error 

Invalid String Character 

Output Errors 

LOAD Program Too Long 
Device Number Larger 
LOAD File Error 
BREAK Abort 
IOCB 

Nonexistent Device 
IOCB Write Only 
Invalid Command 
Device or File not Open 
Bad IOCB Number 
IOCB Read Only Error 
EOF 

Truncated Record 
Device Timeout 
Device NAK 
Serial Bus 

Cursor Out of Range 

Serial Bus Data Frame Overrun 

Serial Bus Data Frame Checksum Error 

Device Done Error 

Read after Write Compare Error 

Function not Implemented 

Insufficient RAM 

Drive Number Error 

Too Many OPEN Files 

Disk Full 

Unrecoverable System Data I/O Error 

File Number Mismatch 

File Name Error 

POINT Data Length Error 

File Locked 

Command Invalid 

Directory Full 

File not Found 

POINT Invalid 


Value Color 

0 Grey 


1 

2 

3 

4 

5 

6 
7 


Gold 

Orange 

Red-Orange 

Pink 

Purple 

Purple-Blue 

Blue 


Value Color 

8 Blue 

9 Light Blue 

10 Turquoise 

11 Green-Blue 

12 Green 

13 Yellow-Green 

14 Orange-Green 

15 Light Orange 


JOYSTICK 


< decimal (binary) > 

14 —( 1110 ) 

( 1010)-10 v 1 6 —( 0110 ) 


(lOll)-ll 



7—(0111) 


(1001)-9 f 5—(0101) 

13 —( 1101 ) 


OPERATORS 


highest 

Token 

50 

51 

52 

47 
49 

48 
54 

35 

36 

39 

37 

38 

32 

33 

34 

29 
31 

30 

40 
42 

41 


precedence: 

Oper. Meaning 

< 

> 


<= 

>= 

<> 

A 

* 

/ 

+ 

< 

> 

<= 

>= 

<> 

NOT 

AND 

OR 


Relational 
operators 
“ used in 
string 

expressions 

Negation 
Exponentiation 
Multiplication 
Division 
Addition 
Substraction 

Relational 
operators 
used in 
numeric 
expressions 

Unary Operator 
Logical AND 
Logical OR 


DEFAULT COLORS 


ADDITIONAL USER NOTES: 

(USE PERMANENT MARKER TO PRESERVE) 


MODE/COLOR TABLE 


SETCOLOR 

Color 

Lum 

Color 

register 

value 

value 


0 

2 

8 

Orange 

1 

12 

10 

Green 

2 

9 

4 

Dark Blue 

3 

4 

6 

Pink 

4 

0 

0 

Black 


Color 

Mode 

SETCOL. 

COLOR 

Application 

_ _ 


0 

COLOR 

_ _ 

Light Green 

Mode 0 

1 

deter- 

Char. Luminance 

Dark Blue 

and 

2 

mines 

Background 

— 

Text 

3 

character 

— 

Black 

Windows 

4 

plotted 

Border 

Orange 


0 

COLOR 

Character 

Light Green 

Modes 

1 

deter- 

Character 

Dark Blue 

1 

2 

mines 

Character 

Red 

and 

3 

character 

Character 

Black 

2 

4 

plotted 

Background, Border 

Orange 

Modes 3, 

0 

1 

Graphics Point 

Light Green 

5, & 7 

1 

2 

Graphics Point 

Dark Blue 

(Four 

2 

3 

Graphics Point 

— 

color 

3 

— 

— 

Black 

modes) 

4 

0 

Gr. Point, Bkgd., Border 

Orange 

Modes 

0 

1 

Graphics Point 

— 

4 & 6 

1 

— 

— 

— 

(Two 

2 

— 

— 

— 

color 

3 

— 

— 

Black 

modes) 

4 

0 

Gr. Point, Bkgd., Border 

_ _ 

Mode 8 

0 

_ _ 

_ _ 

Light Green 

1 color 

1 

1 

Gr. Point Luminance 

Dark Blue 

and 

2 

0 

Gr. Point, Background 

— 

/ 2 lum. 

3 

— 

— 

Black 


4 

— 

Border 


























































































































ANTIC MODES and SCREEN FORMATS 



IMPORTANT MEMORY LOCATIONS—RAM 


ANTIC 

BASIC 

Char or 

Number of 

Xx Y 

Pixel Size 

Bytes per 

Label 

decimal-Location-hex 

Opcode 

Mode 

Bitmap 

Colors 

ColumnsxRows 

HorxVert 

Line/Screen 

RTCLOCK 

18,19,20 

12,13,14 

$2 

2 

0 

Char 

2 

40 x24 

8 

x 8 

40/960 

ICxxxx 

32-47 

20-2F 

$3 

3 

— 

Char 

2 

40 x 19 

8 

x 10 

40/760 

SOUNDR 

65 

41 

$4 

4 

— 

Char 

4 

40 x24 

/ 8 

x 8 

40/960 

ATRACT 

77 

4D 

$5 

5 

— 

Char 

4 

40 x 12 

8 

x 16 

40/480 

LMARGIN 

82 

52 

$6 

6 

1 

Char 

5 

20 x24 

16 

x 8 

20/480 

RMARGIN 

83 

53 

$7 

7 

2 

Char 

5 

20 x 12 

16 

x 16 

20/240 

ROWCRS 

84 

54 

$8 

8 

3 

Bit 

4 

40x24 

8 

x 8 

10/240 

COLCRS 

85,86 

55,56 

$9 

9 

4 

Bit 

2 

80 x48 

4 

x 4 

10/480 

CRMODE 

87 

57 

$A 

10 

5 

Bit 

4 

80 x48 

4 

x 4 

20/960 

SAVMSC 

88,89 

58,59 

$B 

11 

6 

Bit 

2 

160 x 96 

2 

x 2 

20/1920 

OLDROW 

90 

5A 

$C 

12 

— 

Bit 

2 

160 x192 

2 

x 1 

20/3840 

OLDCOL 

91,92 

5B,5C 

$D 

13 

7 

Bit 

4 

160 x 96 

2 

x 2 

40/3840 

NEWROW 

96 

60 

$E 

14 


Bit 

4 

160 x192 

2 

x 1 

40/7680 

NEWCOL 

97,98 

61,62 

$F 

15 

8 

Bit 

2 

—- 

320 x 192 

1 

x 1 

40/7680 

RAMTOP 

LOMEN 

106 

128,129 

6A 

80,81 


ANTIC BLANK-LINE 

opcodes! 


Number of 
Blank Lines 

1 

2 

3 

4 

5 

6 

7 

8 


Opcode 

0 ($ 00 ) 
16 ($10) 
32 ($20) 
48 ($30) 
64 ($40) 
80 ($50) 
96 ($60) 
112 ($70) 


ANTIC INSTRUCTION MODIFIERS 


Instruction 

Type 

Sc 

Hor 

roll 

Vert 

LMS 

DLI 

blank lines 

- - 

- - 

- - 

+128 

($80) 

char/graphics 

+16 

($10) 

+32 

($20) 

+64 

($40) 

+128 

($80) 

JMP =1 ($1) 

* " 

” * 

" “ 

+128 

($80) 

JVB =65 ($41) 

- • 

” - 

" - 

+128 

($80) 


CONNECTOR PINOUTS 


Peripheral Jack 

Ground-. Cassette Motor 


Monitor Jack 


o 


-l Cdi 

<1)1 ol 1 


o 


o 


Sound 


o|<p|o|o|o|<i>|o 


Digital Track In 




Audio Track In 



Video 


FREE RAM IN PAGE ZERO 


176-202 ($B0-$CA) 
203-207 ($CB-$CF) 
208-209 ($D0-$D1) 
212-255 ($D4-$FF) 


free in Assembler 
free in BASIC & Assem 
free in BASIC 
free in Assembler 


FREE RAM ELSEWHERE 


1536-1791 ($600-$6FF), and from 
value in BASIC MEMTOP, 
144,145 ($90,$91), 
to value in OS MEMTOP, 
741,742 ($2E5,$2E6). 


OPERATING SYSTEM ENTRY POINTS 


Label 

decimal-Location-hex 

Function 

DSKINV 

58448 

E450 

Disk Handler init 

DISKV 

58451 

E453 

Disk Handler 

CIOV 

58454 

E456 

Central I/O utility 

SIOV 

58457 

E459 

Serial I/O utility 

SETVBV 

58460 

E45C 

Set System Timers 

SYSVBV • 

58463 1 

E45F 

First stage VBLANK 

XITVBV 

58466 

E462 

Exit VBLANK 

SIOINV 

58469 

E465 

SIO utility init 

SENDEV 

58472 

E468 

Send enable 

INTINV 

58475 

E46B 

Interrupt Handler init 

CIOINV 

58478 

E46E 

CIO utility unit 

BLKBDV 

58481 

E471 

Memo Pad mode 

WARMSV 

58484 

E474 

Warmstart (RESET button) 

COLDSV 

58487 

E477 

Coldstart (power-up) 

| FLOATING POINT ROM ENTRY POINTS 

AFP 

55296 

D800 

ASCII to FP conversion 

FASC 

55526 

D8E6 

FP to ASCII conversion 

IFP 

55722 

D9AA 

Integer to FP conversion 

FPI 

55762 

D9D2 

FP to Integer conversion 

ZFRO 

55876 

DA44 

Clear FP register 0 

ZF1 

55878 

DA46 

Clear FP number 

FSUB 

55904 

DA60 

Floating Point Subtract 

FADD 

55910 

DA66 

Floating Point Add 

FMUL 

56027 

DADB 

Floating Point Multiply 

FDIV 

56104 

DB28 

Floating Point Divide 

PLYEVL 

56640 

DD40 

FP Polynomial Evaluation 

FLDOR 

56713 

DD89 

Load FP number 

FLDOP 

56717 

DD8D 

Load FP number 

FLD1R 

56728 

DD98 

Load FP number 

FLD1P 

56732 

DD9C 

Load FP number 

FSTOR 

56743 

DDA7 

Store FP number 

FSTOP 

56747 

DDAB 

Store FP number 

FMOVE 

56758 

DDB6 

Move FP number 

EXP 

56768 

DDC0 

FP Base e Exponentiation 

EXP10 

56780 

DDCC 

FP Base 10 Exp. 

LOG 

57037 

DECD 

FP Natural Logarithm 

LOG 10 

57041 

DED1 

FP Common Logarithm 


VNTP 

VNTD 

WTP 

STMTAB 

STARP 

MEMTOP 

STOPLN 

ERRSAVE 

PTABW 

FRO 


FR1 

VDSLST 

VBREAK 

CDTMV1-5 

WBLKI 

WBLKD 

CDTMA1 

CDTMA2 

CDTMF3-5 

SDMCTL 

SDLSTL 

LPENH 

LPENV 

COLDST 

GPRIOR 

PADDLO-7 

STICKO-3 

STRIGO-3 

TXTROW 

TXTCOL 

TXTMSC 

BOTSCR 

PCOLRO-3 

COLORO-4 

MEMTOP 

MEMLO 

CRSINH 

CHACT 

CHBAS 

CH 


130,131 

132,133 

134,135 

136,137 

140,141 

144,145 

186,187 

195 

201 

212-217 

212,213 

224,229 

512,513 

518,519 

536-545 

546,547 

548,549 

550,551 

552,553 

554,6,8 

559 

560,561 

564 

565 
580 
623 

624-631 

632-635 

644-647 

656 

657,658 

660,661 

703 

704-707 

708-712 

741,742 

743,744 

752 

755 

756 
764 


82,83 

84,85 

86,87 

88,89 

8C,8D 

90,91 

BA,BB 

C3 

C9 

D4-D9 

D4,D5 

E0-E5 

200,201 

206,207 

218-221 

222,223 

224,225 

226,227 

228,229 

22A,C,E 

22F 

230,231 

234 

235 
244 
26F 

270-277 

278-27B 

284-287 

290 

291,292 

294,295 

2BF 

2C0-2C3 

2C4-2C8 

2E5,2E6 

2E7,2E8 

2F0 

2F3 

2F4 

2FC 


Function 

Internal Clock 
Page Zero IOCB 
Noisy I/O flag (0=quiet) 

Attract Mode flag (128=Attract Mode) 
Left Margin (default=2) 

Right Margin (default=39) 

Current Graphics Cursor Row 
Current Graphics Cursor Column 
BASIC Graphics Mode (0-8) 

Lowest Address of Screen Memory 
Previous Graphics Cursor Row 
Previous Graphics Cursor Column 
Row to which DRAWTO will go 
Column to which DRAWTO will go 
Actual Top of RAM (in pages) 

BASIC Low Memory pointer 
Variable Name Table beginning address 
Variable Name Table ending address+1 
Variable Value Table address 
Statement Table address 
String Array Table address 
BASIC Top of Memory Used pointer 
Line Number of STOP or TRAP 
Error Number causing STOP or TRAP 
PRINT Tab Width (default=10) 

Floating Point Register 0 
Value returned by USR function 
Floating Point Register 1 
Display List Interrupt Vector 
BREAK Vector 

System Timer 1-5 values (low,high) 

Vert. Blank Int. vector (immediate) 

Vert. Blank Int. vector (deferred) 

System Timer 1 time-out jump address 

System Timer 2 time-out jump address 

System Timer 3-5 time-out flags 

DMA enable (0=off) shadow 

Display List Pointer shadow 

Light Pen Horizontal Position 

Light Pen Vertical Position 

1 = Coldstart on RESET 

Priority Control shadow 

Values of Paddle 0-7 

Values of Joystick 0-3 

Joystick Button 0-3 (0=pressed) 

Text Cursor Row 

Text Cursor Colum 

Top left corner of Text Window 

Number of Text Rows (0,4, or 24) 

Color of Player/Missile 0-3 
SETCOLOR registers 0-4 
OS Top of Memory pointer 
OS Bottom of Memory pointer 
Cursor Inhibit (0=cursor on) 

Character Mode Register 
Character Set Base Register 
Last Key Pressed (internal code) 


IMPORTANT MEMORY LOCATIONS—HARDWARE REGISTERS 


(XXX) indicates RAM shadow address 

W=write R=read 

HPOSPO-3 

53248-53251 

D000-D003 

W-Player 0-3 Horizontal Position 

M0-3PF 

53248-53251 

D000-D003 

R-Missile 0-3/Playfield Collision 

HPOSMO-3 

53252-53255 

D004-D007 

W-Missile 0-3 Horizontal Position 

P0-3PF 

53252-53255 

D004-D007 

R-Player 0-3/Playfield Collision 

SIZEPO-3 

53256-53259 

D008-D00B 

W-Size of Player 0-3 

M0-3 PL 

53256-53259 

D008-D00B 

R-Missile 0-3/Player Collision 

SIZEM 

53260 

D00C 

W-Sizes for Missiles 

P0-3PL 

53260-53263 

D00C-D00F 

R-Player 0-3/Player Collision 

GRAFPO-3 

53261-53264 

D00D-D010 

W-Player 0-3 Graphics Data 

TRIGO-3 

53264-53267 

D010-D013 

R-(644-647) Joystick Button 0-3 

GRAFM 

53265 

D011 

W-Graphics for Missiles 

COLPMO-3 

53266-53269 

D012-D015 

W-(704-707) Player/Missile 0-3 Color 

COLPFO-3 

53270-53273 

D016-D019 

W-(708-711) Playfield 0-3 Color 

COLBK 

53274 

D01A 

W-(712) Background Color & Lum 

PRIOR 

53275 

D01B 

W-(623) Priority Control 

VDELAY 

53276 

D01C 

W-Vertical Delay 

GRACTL 

53277 

D01D 

W-Graphics Control 

HITCLR 

53278 

D01E 

W-Clear the Collision Registers 

CONSOL 

53279 

D01F 

R-START/SELECT/OPTION Buttons 

CONSOL 

53279 

D01F 

W-Click Console Speaker 

AUDF1-4 

53760,2,4,6, 

D200,2,4,6 

W-Audio Channel 1-4 Frequency 

AUDC1-4 

53761,3,5,7 

D201,3,5,7 

W-Audio Channel 1-4 Control 

AUDCTL 

53768 

D208 

W-Audio Control 

KBCODE 

53769 

D209 

R-(764) Keyboard Code 

RANDOM 

53770 

D20A 

R-Random Number Generator 

PORTA, B 

54016,54017 

D300,D301 

Controller Jacks 1 & 2 

PA,BCTL 

54018,54019 

D302,D303 

Port A and B Control 

DMACTL 

54272 

D400 

W-(559) DMA Control 

CHACTL 

54273 

D401 

W-(755) Character Control 

DLI STL, H 

54274,54275 

D402,D403 

W-(560,561) Display List pointer 

HSCROL 

54276 

D404 

W-Horizontal Scroll value 

VSCROL 

54277 

D405 

W-Vertical Scroll value 

PMBASE 

54279,54280 

D407,D408 

W-Player/Missile Base Address 

CHBASE 

54281 

D409 

W-(756) Character Base Address 

WSYNC 

54282 

D40A 

W-Wait for Horizontal Sync 

VCOUNT 

54283 

D40B 

R-Vertical Line Counter 

NMIEN 

54286 

D40E 

W-NMI Interrupt Enable 















































